home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1993 July / Internet Tools.iso / RockRidge / mail / mm / mm-manual / 07-custom-ps.mss < prev    next >
Encoding:
Text File  |  1991-01-03  |  13.9 KB  |  356 lines
  1. @part<seven, root="mm.mss">
  2. @begin(text)
  3. @Chapter(Customization)@tag(setcoms)
  4.  
  5. @Section(How to Customize MM)
  6.  
  7. Various options of MM can be changed to customize it.  They all start
  8. out with either default values or no value, and you do not have to
  9. change any of them to use MM.  This manual describes MM behavior based
  10. on the default values.  Once you have worked with MM, you may want to
  11. try changing some of them.
  12.  
  13. Four commands are important in customizing:
  14.  
  15. @begin(itemize)
  16.  
  17. SET <variable-name value>: @i<Set> changes the particular option to
  18. the value you want.
  19.  
  20. SAVE-INIT: @i<Save-init> makes the @i<set> permanent by saving the new
  21. value in the file @i<.mminit> .
  22.  
  23. SHOW <variable-name>: @i<Show> displays the current value of the
  24. variable.  With no variable name it shows all of them.
  25.  
  26. PROFILE: @i<Profile> takes you through some of the most likely options
  27. and asks which way to set each one.  It does what @i<set> and
  28. @i<save-init> do.
  29.  
  30. @end(itemize)
  31.  
  32. Many of the variables take values meaning yes (@i[always, ok, true,
  33. yes]) or no (@i[false, never, no]), or the value @i(ask), which means
  34. to prompt you for yes or no each time.  Some variables instead take
  35. text or other values.
  36.  
  37. For example, to change the setting of the @i<append-signature>
  38. variable to yes, you would enter:
  39.  
  40. @blankspace(1 line)
  41. @end(text)
  42. @begin(text2)
  43. @begin<example>
  44.  
  45. MM>@b<set append-signature yes>
  46.  
  47. @end<example>
  48. @end(text2)
  49. @begin(text)
  50.  
  51. @section(Description of Variables)
  52.  
  53. The following are the variables and the optional settings available
  54. followed by the system defaults.  Many of these settings are fairly
  55. obscure and you will not find much need to change them.  For longer
  56. descriptions of each variable, type @i(help set <variable-name>).
  57.  
  58. The most commonly changed variable settings are indicated by
  59. checkmarks.
  60.  
  61. @blankspace(1 line)
  62. @end(text)
  63. @begin(text2, columnbalance=on)
  64. @begin(itemize)
  65.  
  66. ALIASES-USE-GROUPS: If yes, aliases defined using the @i[define]
  67. command show only the alias name in the @i[to] field of outgoing
  68. messages.  If no, all the user ID's that the alias has included will
  69. be listed.  The default is no.
  70.  
  71. @zf<4>@b< APPEND-SIGNATURE>: If yes, the @i<.signature> file in your
  72. home directory will automatically be added to the bottom of your
  73. outgoing mail.  The default is no.
  74.  
  75. AUTO-STARTUP-GET: If yes, MM will get your mail file for you
  76. automatically upon entry.  The default is yes.
  77.  
  78. AUTOWRAP-COLUMN: The numeric argument specifies the column at which to
  79. perform automatic word wrapping while collecting a message.  If the
  80. number is positive, it indicates the absolute column at which to wrap.
  81. If it is negative, it indicates the number of column spaces from the
  82. right side of the screen. If it is zero, no wrapping is done.  The
  83. default is -7.
  84.  
  85. BROWSE-CLEAR-SCREEN: If yes, the browser will clear the screen at
  86. every opportunity.  The default is yes.
  87.  
  88. BROWSE-PAUSE: If yes, always pause between messages when browsing.
  89. The default is yes.
  90.  
  91. @zf<4>@b< CHECK-INTERVAL>: Defines the time in seconds between each
  92. check for new mail.  The default is 300 (5 minutes).  0 means never.
  93.  
  94. CLEAR-SCREEN: If yes, the screen is cleared at startup and between
  95. messages.  The default is yes.
  96.  
  97. CONTINUOUS-CHECK: If yes, checking for new mail is also done in
  98. @i<send> and @i<read> modes.  The default is no.
  99.  
  100. CONTROL-D-AUTOMATIC-@*SEND: If yes, send message automatically on
  101. @i(<ctrl/d>) from text mode.  The default is no.
  102.  
  103. CONTROL-E-EDITOR: If yes, @i(<ctrl/e>) invokes the editor in message
  104. collection mode.  The default is yes.
  105.  
  106. CONTROL-L-CONFIRM: If yes, typing @i(<ctrl/l>) will enter a @i<<cr>>
  107. as well as clear the screen: if there is a command typed at the
  108. prompt when you type CTRL-L, the screen will be cleared and the
  109. command will be executed.  The default is no.
  110.  
  111. CONTROL-N-ABORT: If yes, then @i(<ctrl/n>) aborts the current command.
  112. If ask, then @i(<ctrl/n>) should ask before aborting.  If no, then
  113. @i(<ctrl/n>) never aborts.  The default is ask.
  114.  
  115. CRT-FILTER: Gives the program to use to display messages one screen of
  116. text at a time.  The default is /usr/ucb/more -x (the more program).
  117.  
  118. DEFAULT-BCC-LIST: Defines a list of recipients that should always be
  119. included in the bcc: (blind carbon copy) header field.  There is no
  120. default.
  121.  
  122. @zf<4>@b< DEFAULT-CC-LIST>: Gives a list of addresses that will always
  123. be in the cc (carbon copy) header field of your outgoing messages.
  124. There is no default.
  125.  
  126. @zf<4>@b< DEFAULT-FCC-LIST>: Defines a file name (or list of file
  127. names) in which to put a carbon copy of all outgoing messages.  There
  128. is no default.  You should specify the path, because otherwise the
  129. file is always assumed to be in the current directory.
  130.  
  131. DEFAULT-FROM: Defines what will go in the from field in outgoing mail.
  132. In addition, your user ID will appear in the @i<Sender:> field for
  133. outgoing mail.  There is no default.
  134.  
  135. DEFAULT-MAIL-TYPE: Indicates the mail format for new or empty files.
  136. There are currently four mail formats available: babyl, mbox, mtxt and
  137. MH.  The default is mbox.
  138.  
  139. DEFAULT-READ-COMMAND: Defines a command to automatically execute when
  140. you type @i[<cr>] while reading messages.  The default is @i<next>.
  141.  
  142. DEFAULT-REPLY-TO: Defines a @i<reply-to:> field automatically in
  143. out-going mail.  There is no default.
  144.  
  145. DEFAULT-SEND-COMMAND: Defines the command to automatically execute
  146. when you type @i<<cr>> at the @i<send>> prompt.  There is no default.
  147.  
  148. DIRECTORY-FOLDERS: This is only relevant when using MH format mail
  149. files.  This variable will allow MM to not add a slash when trying to
  150. complete a mail folder name on the command line.  This is because the
  151. MH format uses a directory for a mail folder.  The default is no.
  152.  
  153. DISPLAY-FLAGGED-@*MESSAGES: If yes, display @i<flagged> messages when
  154. the mail file is read into MM.  The default is yes.
  155.  
  156. @zf<4>@b< DISPLAY-OUTGOING->@*@b<MESSAGE>: If yes, the contents of the
  157. message you've already composed will be displayed when you re-enter
  158. text mode.  The default is no.
  159.  
  160. DONT-PRINT-HEADERS: Gives a list of header fields that should not
  161. appear when you use the @i<print> or @i<list> commands.  There is no
  162. default.
  163.  
  164. @zf<4>@b< DONT-TYPE-HEADERS>: Gives a list of header fields that
  165. should not be shown when displaying messages.  There is no default.
  166. See page @pageref<donttype> for an example.
  167.  
  168. EDITOR: Indicates the editor you want to use when creating or editing
  169. messages.  The default is /usr/local/bin/emacs.
  170.  
  171. ESCAPE-AUTOMATIC-SEND: If yes, then the message will automatically be
  172. sent from send-text mode when @i<[ESC]> is typed.  The default is no.
  173.  
  174. EXPUNGE-ON-BYE: If yes, MM will automatically expunge the messages
  175. marked for deletion when you exit using the @i<bye> command.  The
  176. default is ask.
  177.  
  178. FAST-INIT-FILE: If yes, then use fast format initialization file, which
  179. means write the file @i<~/.mmfast> as a summary of your @i<.mminit>
  180. file.  The default is yes.
  181.  
  182. FINGER-COMMAND: Defines the command to execute when the @i<finger>
  183. command is called.  The default is @i<finger>.
  184.  
  185. GNUEMACS-MMAIL: If your editor variable is not @i<emacs>, then this
  186. variable doesn't apply.  If it is @i<emacs> and the value of this
  187. variable is yes, it will use the mmail mode in the editor gnuemacs
  188. automatically.  This gives you a window for the headers or message to
  189. which you may be replying and a window for the text of your message.
  190. The default is yes.
  191.  
  192. HEADER-OPTIONS-FILE: Gives the name of a file that contains header
  193. fields you would like to appear in all your outgoing mail.  For
  194. example, if you want to make a header @i<Office: 816 Watson>, you may
  195. first create a file called @i<.mm-headers>, with the file consisting
  196. of the header line.  Then say @i<set header-options-file .mm-headers>.
  197. All your outgoing messages will then bear the @i<Office...> header.
  198. There is no default for this variable.
  199.  
  200. INCOMING-MAIL: Gives the file name of the mailbox that MM should
  201. check for new mail.  The default is /usr/spool/mail/@i<your user ID>.
  202.  
  203. KEYWORDS: Defines a list of keywords you may use in conjunction with
  204. the @i<keyword> command.  By defining keywords here, you will be able
  205. to use command completion in assigning your keywords when you use the
  206. @i<keyword> command.  There is no default.
  207.  
  208. LIST-INCLUDE-HEADERS: If yes, the index headers (like @i<headers>
  209. command) for each message will be listed out before displaying
  210. messages using the @i<list> command.  The default is yes.
  211.  
  212. LIST-ON-SEPARATE-PAGES: If yes, put a form feed between each message
  213. listed while printing a group of messages.  The default is no.
  214.  
  215. MAIL-DIRECTORY: Defines the directory in which to keep your primary
  216. mail file and related files.  The default is ~, your home directory.
  217.  
  218. MAIL-FILE: Defines the file in which to store incoming messages (new
  219. mail).  The default is mbox.
  220.  
  221. MMAIL-PATH: Defines the file name for the gnuemacs mmail library.
  222. This is not for general usage.  There is no default.
  223.  
  224. MODIFY-READ-ONLY: If yes, then when you are using a read-only mail
  225. file (as when using the @i<examine> command) you can modify the file
  226. in the buffer (the disk is still read-only).  Otherwise, you will get
  227. an error message when you try to use any command that marks the
  228. messages (i.e. read, delete, etc.)  The default is yes.
  229.  
  230. MOVEMAIL-PATH: Defines the path for the MM program to move mail from
  231. the spool directory to your home directory.  The default is
  232. /usr/local/lib/mm/movemail .
  233.  
  234. NEW-FILE-MODE: The numeric argument is the octal default file mode for
  235. files created by @i<move>, @i<copy>, etc.  The default of @i<600>
  236. gives the highest level of protection, which is read/write by owner
  237. only.
  238.  
  239. ONLY-PRINT-HEADERS: Gives a list of header fields that would be the
  240. only ones shown when you use the @i<print> or @i<list> commands.
  241. There is no default.
  242.  
  243. ONLY-TYPE-HEADERS: Gives a list of header fields that would be the
  244. only ones displayed during message typeout.  There is no default.
  245.  
  246. @zf<4>@b< PERSONAL-NAME>: Gives a string for your name as it should
  247. appear in outgoing mail in the @i<from> field.  There is no default.
  248. So if you don't enter a @i<personal-name>, your user ID and name from
  249. @i</etc/passwd> will appear in that field.
  250.  
  251. @zf<4>@b< PRINT-FILTER>: Defines the program to use to print messages.  The
  252. default is /usr/local@|/bin@|/print.  If you are using Kermit on a PC and have
  253. a printer directly hooked up to it, try setting it to pcprint.
  254.  
  255. PROMPT-FOR-BCC: If yes, prompt for blind carbon copy during send
  256. command. The default is no.
  257.  
  258. PROMPT-FOR-CC: If yes, prompt for carbon copy during send command. The
  259. default is yes.
  260.  
  261. PROMPT-FOR-FCC: If yes, prompt for the name of a file to automatically
  262. put a copy of your outgoing message into during the send command. The
  263. default is no.
  264.  
  265. PROMPT-RCPT-ALWAYS: If yes, always prompt for the recipients when
  266. sending or replying.  The default is no.
  267.  
  268. @zf<4>@b< READ-PROMPT>: Defines the string to be used as the read prompt.  The
  269. default is @i(Read>).
  270.  
  271. @zf<4>@b< REPLY-ALL>: If yes, replies go to all recipients (not just sender).
  272. The default is no.
  273.  
  274. @zf<4>@b< REPLY-INCLUDE-ME>: If yes, when you are replying to a
  275. message and say @i<reply all>, replies go to your user ID also.  The
  276. default is no.
  277.  
  278. REPLY-INDENT: Gives the indentation string to be used for the included
  279. message when including original message into reply.  The default is
  280. "> ".
  281.  
  282. REPLY-INITIAL-DISPLAY: If yes, display the headers associated with the
  283. reply to a message after the @i<reply> command is typed.  The
  284. default is no.
  285.  
  286. REPLY-INSERT: If yes, the @i<reply> command includes the original
  287. message automatically.  The default is no.
  288.  
  289. @zf<4>@b< SAVED-MESSAGES-FILE>: Defines a file that will automatically
  290. receive copies of all your outgoing messages.  There is no default.
  291. If the directory is not specified, the mail-directory is assumed.
  292.  
  293. @zf<4>@b< SEND-PROMPT>: Defines the string to be used as the send prompt.
  294. The default is @i<Send>>.
  295.  
  296. SEND-VERBOSE: If yes, after entering @i<send> at the send prompt to
  297. mail your outgoing message, the recipients of the mail you have just
  298. sent will be displayed.  The default is yes.
  299.  
  300. SENDMAIL-BACKGROUND: If yes, MM won't wait for the sendmail program to
  301. finish running before continuing with MM commands.  The default is
  302. yes.
  303.  
  304. SENDMAIL-VERBOSE: If yes, display the mail sender program messages
  305. about mail delivery.  The default is no.
  306.  
  307. SPELLER: Defines the spell checker that is to be used with the
  308. @i<spell> command.  The default is @i<ispell>.
  309.  
  310. SUSPEND-ON-EXIT: If yes, when using the @i<exit> command to get out of
  311. MM, the process will be suspended.  The default is yes.
  312.  
  313. SUSPEND-ON-QUIT: If yes, when using the @i<quit> command to get out of
  314. MM, the process will be suspended.  The default is yes.
  315.  
  316. TEMP-DIRECTORY: Gives the directory to create temporary files in.  The
  317. default is ~, your home directory.
  318.  
  319. @zf<4>@b< TERSE-TEXT-PROMPT>: If yes, the prompt for message body in text
  320. mode will be just @b[Msg:].  The default is no.
  321.  
  322. TOP-LEVEL-PROMPT: Gives the string to be used as the top-level command
  323. prompt.  The default is @i<MM>>.
  324.  
  325. USE-CRT-FILTER-ALWAYS: If yes, messages will be piped to crt-filter
  326. regardless of length.  If no, your crt-filter will be used only when
  327. the message is too big to fit on your screen all at once.  The default
  328. is no.
  329.  
  330. @zf<4>@b< USE-EDITOR-ALWAYS>: If yes, the editor defined by the editor variable
  331. will automatically be used to compose messages.  The default is no.
  332.  
  333. USE-INVALID-ADDRESS: If yes, strange mail address formats will be
  334. accepted by MM in the @i<reply>, @i<forward>, and @i<edit> commands
  335. (e.g.  hostname::username).  The default is ask.
  336.  
  337. USER-HEADERS: Gives a list of header fields you may wish to add to
  338. outgoing messages.  Defining this variable allows for command
  339. completion to be used with the @i<user-header> command in @i<send> mode.
  340. There is no default.
  341.  
  342. @zf<4>@b< USER-LEVEL>: Defines the level of expertise for the user.
  343. The options are @i<novice> and @i<expert>.  If the level is set to
  344. novice, the one-line display of "hints" will appear at each of the
  345. prompts.  At expert level, the "hints" disappear.  The default
  346. is @i<novice>.
  347.  
  348. USER-NAME: Defines the user name for a particular UID.  For the
  349. general user population this command does not apply.  If you would
  350. like to have a nickname appear in the @i<from> field, use the
  351. @i<personal-name> variable.
  352.  
  353. @end(itemize)
  354.  
  355. @end<text2>
  356.